home *** CD-ROM | disk | FTP | other *** search
/ Especial Multimedia / Especial Multimedia.iso / Multimed / Prg / DIBDLL.ZIP / DIBDLL.TXT < prev    next >
Text File  |  1992-12-21  |  3KB  |  78 lines
  1. DIB.DLL will display a device independent bitmap in a topmost,
  2. overlapped window.  DIB.DLL is similar to Borland's DRAWBITS.DLL
  3. except:
  4.  
  5.   1) It supports 256 color (or more) bitmaps
  6.  
  7.   2) Multiple bitmaps may be displayed at once, each in a 
  8.      separate window
  9.  
  10.   3) The bitmap window(s) may be closed, moved, resized, 
  11.      minimized and maximized by the user
  12.  
  13.   4) The bitmap window(s) may be positioned, scaled and closed programatically.
  14.  
  15.  
  16. Using DIB.DLL with ObjectVision
  17.  
  18.   A sample application, TESTDIB.OVD, is provided to demonstrate the use of
  19.   the DIB.DLL @functions.  You should review this application if the instructions
  20.   below are not clear.
  21.  
  22.   1) Register the two @functions within DIB.DLL by placing
  23.      the following commands in the event tree for the application:
  24.  
  25.        @REGISTER("@ShowDIB","ACIIB","DIB File Name, Xpos, Ypos, Scale %","DIB.DLL","ShowDIB",1)
  26.        @REGISTER("@CloseDIB","AC","DIB File Name","DIB.DLL","CloseDIB",1)
  27.  
  28.      It is probably easiest just to copy these from the event tree of TESTDIB.OVD
  29.      and paste them into your application.
  30.  
  31.   2) Display a bitmap by calling "@ShowDIB" as follows:
  32.  
  33.        @ShowDIB('File Name:','X Pos:','Y Pos:','Scale:')
  34.  
  35.      where:
  36.  
  37.        'File Name:' = A character string giving the name of the
  38.                       bitmap file on disk.  If the directory where
  39.                       this file resides is not in your DOS PATH,
  40.                       the full path name must be provided.
  41.  
  42.        'X Pos:'     = The horizontal position, in global coordinates,
  43.                       for the upper right corner of the bitmap window.
  44.  
  45.        'Y Pos:'     = The vertical position, in global coordinates,
  46.                       for the upper right corner of the bitmap window.
  47.  
  48.        'Scale:'        = The scale factor for initial sizing of the bitmap,
  49.                       expressed as a percent (1 = 100%).
  50.  
  51.       See the event tree of the "Show" button within the sample application
  52.       for more information.  @ShowDIB returns Yes (true) if the bitmap
  53.       was successfully displayed, otherwise it returns No (false).
  54.  
  55.    3) Close the bitmap by calling "@CloseDIB" as follows:
  56.  
  57.         @CloseDIB('File Name:')
  58.  
  59.       where 'File Name:' is the name of the bitmap file as displayed in the
  60.       bitmap window's title bar.  If more than one window contains a bitmap
  61.       by this name, ALL windows containing this bitmap will be closed.
  62.  
  63.       See the event tree for the "Close" button within the sample application
  64.       for more information.  @CloseDIB returns Yes (true) if the bitmap window
  65.       was successfully removed, otherwise it returns No (false).
  66.  
  67. This DLL was written for fun and is provided to you in this same spirit.  It is
  68. not intended for commericial use or profit and may not be used for these purposes
  69. without the written consent of the author.  Those wishing to use these routines
  70. for purposes other than personal enjoyment should contact me via Compuserve.  Likewise,
  71. those desiring source code, enhancements or wishing to express an opinion regarding 
  72. this work should contact me via email.
  73.  
  74. I hope you find this software enjoyable.
  75.  
  76.  
  77. Steve Ura
  78. 72406,3660